home *** CD-ROM | disk | FTP | other *** search
/ IRIX Base Documentation 1998 November / IRIX 6.5.2 Base Documentation November 1998.img / usr / share / catman / u_man / cat1 / pmprobe.z / pmprobe
Text File  |  1998-10-20  |  10KB  |  133 lines
  1.  
  2.  
  3.  
  4. PPPPMMMMPPPPRRRROOOOBBBBEEEE((((1111))))                                                          PPPPMMMMPPPPRRRROOOOBBBBEEEE((((1111))))
  5.  
  6.  
  7.  
  8. NNNNAAAAMMMMEEEE
  9.      ppppmmmmpppprrrroooobbbbeeee - lightweight probe for performance metrics
  10.  
  11. SSSSYYYYNNNNOOOOPPPPSSSSIIIISSSS
  12.      ppppmmmmpppprrrroooobbbbeeee [----IIIIiiiiVVVVvvvv] [----aaaa _a_r_c_h_i_v_e] [----hhhh _h_o_s_t_n_a_m_e] [----nnnn _p_m_n_s_f_i_l_e] [_m_e_t_r_i_c_n_a_m_e ...]
  13.  
  14. DDDDEEEESSSSCCCCRRRRIIIIPPPPTTTTIIIIOOOONNNN
  15.      ppppmmmmpppprrrroooobbbbeeee determines the availability of performance metrics exported
  16.      through the facilities of the Performance Co-Pilot (PCP).
  17.  
  18.      The metrics of interest are named in the _m_e_t_r_i_c_n_a_m_e arguments.  If
  19.      _m_e_t_r_i_c_n_a_m_e is a non-leaf node in the Performance Metrics Name Space
  20.      (ppppmmmmnnnnssss(4)), then ppppmmmmpppprrrroooobbbbeeee will recursively descend the PMNS and report on
  21.      all leaf nodes.  If no _m_e_t_r_i_c_n_a_m_e argument is given, the root of the
  22.      namespace is used.
  23.  
  24.      The output format is spartan and intended for use in wrapper scripts
  25.      creating configuration files for other PCP tools.  By default, there is
  26.      one line of output per metric, with the metric name followed by a count
  27.      of the number of available values.  Error conditions are encoded as a
  28.      negative value count (as per the PPPPMMMMAAAAPPPPIIII(3) protocols, but may be decoded
  29.      using ppppmmmmeeeerrrrrrrr(1)) and followed by a textual description of the error.
  30.  
  31.      Unless directed to another host by the ----hhhh option, ppppmmmmpppprrrroooobbbbeeee will contact
  32.      the Performance Metrics Collector Daemon (PMCD) on the local host.
  33.  
  34.      The ----aaaa option causes ppppmmmmpppprrrroooobbbbeeee to use the specified archive rather than
  35.      connecting to a PMCD.  The ----aaaa and ----hhhh options are mutually exclusive.
  36.  
  37.      Normally ppppmmmmpppprrrroooobbbbeeee operates on the default Performance Metrics Name Space
  38.      (PMNS), however, if the ----nnnn option is specified an alternative namespace
  39.      is loaded from the file _p_m_n_s_f_i_l_e.  Independent of the ----nnnn option, the
  40.      namespace is always local to the machine on which ppppmmmmpppprrrroooobbbbeeee is run.
  41.  
  42.      Other options control the output of additional information when one or
  43.      more values is available.
  44.  
  45.      ----IIII   Report the external identifiers for each instance.  The literal
  46.           string PPPPMMMM____IIIINNNN____NNNNUUUULLLLLLLL is reported for singular metrics.
  47.  
  48.      ----iiii   Report the internal identifiers for each instance.  The values are
  49.           in decimal and prefixed by ``?''.  As a special case, the literal
  50.           string PPPPMMMM____IIIINNNN____NNNNUUUULLLLLLLL is reported for singular metrics.
  51.  
  52.      ----vvvv   Report the value for each instance, as per the formatting rules of
  53.           ppppmmmmPPPPrrrriiiinnnnttttVVVVaaaalllluuuueeee(3).
  54.  
  55.      The ----IIII, ----iiii and ----vvvv options are mutually exclusive.
  56.  
  57.      The ----VVVV option provides a cryptic summary of the number of messages sent
  58.      and received across the PMAPI interface.
  59.  
  60.  
  61.  
  62.  
  63.                                                                         PPPPaaaaggggeeee 1111
  64.  
  65.  
  66.  
  67.  
  68.  
  69.  
  70. PPPPMMMMPPPPRRRROOOOBBBBEEEE((((1111))))                                                          PPPPMMMMPPPPRRRROOOOBBBBEEEE((((1111))))
  71.  
  72.  
  73.  
  74. EEEEXXXXAAAAMMMMPPPPLLLLEEEESSSS
  75.      _$$$$ _pppp_mmmm_pppp_rrrr_oooo_bbbb_eeee _iiii_rrrr_iiii_xxxx_...._dddd_iiii_ssss_kkkk_...._dddd_eeee_vvvv
  76.      _iiii_rrrr_iiii_xxxx_...._dddd_iiii_ssss_kkkk_...._dddd_eeee_vvvv_...._rrrr_eeee_aaaa_dddd _2222
  77.      _iiii_rrrr_iiii_xxxx_...._dddd_iiii_ssss_kkkk_...._dddd_eeee_vvvv_...._wwww_rrrr_iiii_tttt_eeee _2222
  78.      _iiii_rrrr_iiii_xxxx_...._dddd_iiii_ssss_kkkk_...._dddd_eeee_vvvv_...._tttt_oooo_tttt_aaaa_llll _2222
  79.      _iiii_rrrr_iiii_xxxx_...._dddd_iiii_ssss_kkkk_...._dddd_eeee_vvvv_...._bbbb_llll_kkkk_rrrr_eeee_aaaa_dddd _2222
  80.      _iiii_rrrr_iiii_xxxx_...._dddd_iiii_ssss_kkkk_...._dddd_eeee_vvvv_...._bbbb_llll_kkkk_wwww_rrrr_iiii_tttt_eeee _2222
  81.      _iiii_rrrr_iiii_xxxx_...._dddd_iiii_ssss_kkkk_...._dddd_eeee_vvvv_...._bbbb_llll_kkkk_tttt_oooo_tttt_aaaa_llll _2222
  82.      _iiii_rrrr_iiii_xxxx_...._dddd_iiii_ssss_kkkk_...._dddd_eeee_vvvv_...._aaaa_cccc_tttt_iiii_vvvv_eeee _2222
  83.      _iiii_rrrr_iiii_xxxx_...._dddd_iiii_ssss_kkkk_...._dddd_eeee_vvvv_...._rrrr_eeee_ssss_pppp_oooo_nnnn_ssss_eeee _2222
  84.  
  85.      _$$$$ _pppp_mmmm_pppp_rrrr_oooo_bbbb_eeee _----_IIII _iiii_rrrr_iiii_xxxx_...._dddd_iiii_ssss_kkkk_...._dddd_eeee_vvvv_...._rrrr_eeee_aaaa_dddd _iiii_rrrr_iiii_xxxx_...._dddd_iiii_ssss_kkkk_...._dddd_eeee_vvvv_...._wwww_rrrr_iiii_tttt_eeee _\\\\
  86.        _iiii_rrrr_iiii_xxxx_...._dddd_iiii_ssss_kkkk_...._aaaa_llll_llll_...._tttt_oooo_tttt_aaaa_llll
  87.      _iiii_rrrr_iiii_xxxx_...._dddd_iiii_ssss_kkkk_...._dddd_eeee_vvvv_...._rrrr_eeee_aaaa_dddd _2222 _""""_dddd_kkkk_ssss_0000_dddd_1111_"""" _""""_dddd_kkkk_ssss_0000_dddd_2222_""""
  88.      _iiii_rrrr_iiii_xxxx_...._dddd_iiii_ssss_kkkk_...._dddd_eeee_vvvv_...._wwww_rrrr_iiii_tttt_eeee _2222 _""""_dddd_kkkk_ssss_0000_dddd_1111_"""" _""""_dddd_kkkk_ssss_0000_dddd_2222_""""
  89.      _iiii_rrrr_iiii_xxxx_...._dddd_iiii_ssss_kkkk_...._aaaa_llll_llll_...._tttt_oooo_tttt_aaaa_llll _1111 _PPPP_MMMM______IIII_NNNN______NNNN_UUUU_LLLL_LLLL
  90.  
  91.      _$$$$ _pppp_mmmm_pppp_rrrr_oooo_bbbb_eeee _----_vvvv _pppp_mmmm_cccc_dddd_...._nnnn_uuuu_mmmm_aaaa_gggg_eeee_nnnn_tttt_ssss _pppp_mmmm_cccc_dddd_...._vvvv_eeee_rrrr_ssss_iiii_oooo_nnnn _pppp_mmmm_cccc_dddd_...._cccc_oooo_nnnn_tttt_rrrr_oooo_llll_...._tttt_iiii_mmmm_eeee_oooo_uuuu_tttt
  92.      _pppp_mmmm_cccc_dddd_...._nnnn_uuuu_mmmm_aaaa_gggg_eeee_nnnn_tttt_ssss _1111 _9999
  93.      _pppp_mmmm_cccc_dddd_...._vvvv_eeee_rrrr_ssss_iiii_oooo_nnnn _1111 _""""_2222_...._0000 _bbbb_eeee_tttt_aaaa_----_1111_""""
  94.      _pppp_mmmm_cccc_dddd_...._cccc_oooo_nnnn_tttt_rrrr_oooo_llll_...._tttt_iiii_mmmm_eeee_oooo_uuuu_tttt _1111 _5555
  95.  
  96.      _$$$$ _pppp_mmmm_pppp_rrrr_oooo_bbbb_eeee _----_vvvv _dddd_iiii_ssss_kkkk_...._dddd_eeee_vvvv_...._tttt_oooo_tttt_aaaa_llll _iiii_rrrr_iiii_xxxx_...._dddd_iiii_ssss_kkkk_...._aaaa_llll_llll_...._tttt_oooo_tttt_aaaa_llll
  97.      _dddd_iiii_ssss_kkkk_...._dddd_eeee_vvvv_...._tttt_oooo_tttt_aaaa_llll _----_1111_0000_1111_2222 _UUUU_nnnn_kkkk_nnnn_oooo_wwww_nnnn _mmmm_eeee_tttt_rrrr_iiii_cccc _nnnn_aaaa_mmmm_eeee
  98.      _iiii_rrrr_iiii_xxxx_...._dddd_iiii_ssss_kkkk_...._aaaa_llll_llll_...._tttt_oooo_tttt_aaaa_llll _1111 _4444_9999_9999_2222_4444_6666_6666
  99.  
  100. FFFFIIIILLLLEEEESSSS
  101.      ////vvvvaaaarrrr////ppppccccpppp////ppppmmmmnnnnssss////*         default PMNS specification files
  102.  
  103. SSSSEEEEEEEE AAAALLLLSSSSOOOO
  104.      PPPPCCCCPPPPIIIInnnnttttrrrroooo(1), ppppmmmmccccdddd(1), ppppmmmmcccchhhhaaaarrrrtttt(1), ppppmmmmdddduuuummmmpppplllloooogggg(1), ppppmmmmiiiinnnnffffoooo(1), PPPPMMMMAAAAPPPPIIII(3),
  105.      ppppmmmmEEEErrrrrrrrSSSSttttrrrr(3) and ppppmmmmnnnnssss(4).
  106.  
  107.  
  108.  
  109.  
  110.  
  111.  
  112.  
  113.  
  114.  
  115.  
  116.  
  117.  
  118.  
  119.  
  120.  
  121.  
  122.  
  123.  
  124.  
  125.  
  126.  
  127.  
  128.  
  129.                                                                         PPPPaaaaggggeeee 2222
  130.  
  131.  
  132.  
  133.